home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 4 / CU Amiga Magazine's Super CD-ROM 04 (1996)(EMAP Images)(GB)(Track 1 of 3)[!][issue 1996-11].iso / magazine / psion / utils / funzip12.lzx / unzip.txt < prev   
Text File  |  1980-01-01  |  16KB  |  555 lines
  1. Unzip v1.2 (Archive: FUNZIP12.ZIP)
  2. ==================================
  3.  
  4. This is a freeware user-friendly shell (front-end)
  5. for the UNZIP.IMG image file from David Palmer.
  6. The UNZIP.IMG file can be found on CompuServe in
  7. the Palmtop forum library 18 in different versions
  8. (see the Installation section below)
  9.  
  10. As with any freeware, I disclaim any liability
  11. whatsoever for problems created by this program.
  12. Although it works fine on my Psion 3a computers,
  13. I do not guarantee that this program is error
  14. free and I will not be held responsible for any
  15. damage or loss of any kind whatsoever.
  16.  
  17.         *** USE AT YOUR OWN RISK ***
  18.  
  19. That said, I believe I have found all bugs and that
  20. Unzip is stable and reliable.
  21.  
  22. I wrote this application as I could never remember
  23. the command line options I needed to unzip files.
  24. As David had kindly added full OPL launch support
  25. from version 1.4 of his UNZIP.IMG, I was inspired
  26. to create this very useful shell for David's unzip
  27. utility.
  28.  
  29. Unzip can be used as a replacement for, or a
  30. supplement to David Palmer's RUN.APP.
  31.  
  32.  
  33.  
  34. New Features in This Version (v1.2)
  35. ===================================
  36. * UNZIP.IMG v1.50 support only
  37. * Nice new icon
  38. * Directories used are remembered
  39. * Online-help
  40. * Create file list action
  41. * Selectable file types
  42. * Easier dialog
  43. * Uses much less run-time memory
  44. * Variant added for original series 3 users
  45. See the change history at then end of this file
  46. for exact change details.
  47.  
  48.  
  49.  
  50. Archive Contents
  51. ================
  52. When you unzipped this file you should have
  53. found:
  54.  
  55.    File      Size Time    Date
  56.  UNZIP.TXT  16341 01:20 21-Jun-96 (this file)
  57.  UNZIP.OPA   2937 01:20 21-Jun-96 (series 3a app)
  58.  UNZIP.HLP   1689 01:20 21-Jun-96 (help file)
  59.  UNZIP.CLS   2393 01:20 21-Jun-96 (series 3 app)
  60.  
  61.  
  62.  
  63. Installation
  64. ============
  65. NOTE: If you have a series 3 (not a 3a) then 
  66. please read the Variants of UNZIP.OPA section
  67. towards the end of this file before proceding
  68. any further.
  69.  
  70. 1. Make sure you have v1.50 of the UNZIP.IMG file.
  71.    UNZIP.IMG is part of the complete unzip package
  72.    from David Palmer, which is available as...
  73.  
  74.      Archive         UNZIP.IMG Version
  75.     S3UZ150L.ZIP       v1.50l (preferred)
  76.     S3UZ150S.ZIP       v1.50s
  77.     S3UNZIP.ZIP        v1.50l & v1.50s
  78.  
  79.      File             Version
  80.     UNZIP.IMG          v1.50l
  81.  
  82.    ...in the CompuServe Palmtop forum's library 18.
  83.    You can also get UNZIP.IMG v1.50 by anonymous
  84.    ftp from
  85.    ftp://sunsite.doc.ic.ac.uk/computing/systems/
  86.    handhelds/psion/icdoc/utils/s3uzip15s.zip or
  87.    s3uzip15l.zip
  88.    For a detailed explanation of the difference
  89.    between v1.50l and v1.50s, see the section
  90.    "Variants of UNZIP.IMG" later on in this file.
  91.  
  92. 2. Series 3 users only: 
  93.    Delete the supplied UNZIP.OPA (it is not
  94.    required) and rename the file UNZIP.CLS 
  95.    to UNZIP.OPA
  96.  
  97. 3. Copy UNZIP.OPA into the *same* directory as
  98.    UNZIP.IMG
  99.    To retain compatibility with RUN.APP, use a
  100.    \RUN\ directory.
  101.    If you do not have RUN.APP installed (or wish
  102.    to remove it) then I recommend to copy the
  103.    files including UNZIP.IMG to an \APP\UNZIP\
  104.    directory.
  105.    NOTE: UNZIP.OPA will not work unless it is in
  106.    the same directory and on the same disk as
  107.    UNZIP.IMG.
  108.    The file *must* be named UNZIP.OPA
  109.  
  110. 4. Series 3a users only: 
  111.    If you wish to access online help for UNZIP.OPA,
  112.    then copy UNZIP.HLP into the same directory as
  113.    UNZIP.OPA.
  114.    Online help is optional: if you already know
  115.    how to unzip and wish to save memory space,
  116.    you may omit the help file.
  117.  
  118. 5. Install the UNZIP.OPA application from the
  119.    system screen by using Psion-I, pressing Tab,
  120.    and navigating to the directory where Unzip is
  121.    located.
  122.  
  123.    NOTE: all you need to unzip is UNZIP.IMG and
  124.    UNZIP.OPA. For the optional online help you
  125.    also need UNZIP.HLP. All other files in David
  126.    Palmer's archive can be deleted from the Psion
  127.    if you need to save precious memory space.
  128.  
  129.  
  130.  
  131. Operation
  132. =========
  133. Unzip contains a simple dialog for selecting the
  134. usual unzip options.
  135. All options provided by UNZIP.IMG v1.50 are
  136. supported by the Unzip shell.
  137. When you start Unzip (the same way as you would
  138. start any other application) you will see a dialog
  139. that will look like this...
  140.  
  141.  
  142.          Unzip v1.2    [Esc] to exit
  143.  
  144.  Unzip from file: Name    <file>
  145.                   Disk    Internal
  146.  Unzip to directory: Name \
  147.                      Disk Internal
  148.  Action:                  Extract files
  149.  File types:              All (*.*)
  150.  Overwrite:               Prompt
  151.  Options:                 None
  152.  
  153. NOTE: The example shows the series 3a variant, the
  154. series 3 variant looks slightly different.
  155. If you get any error messages on startup, see the
  156. section "Solving Problems" later on in this file.
  157.  
  158. If you have UNZIP.IMG v1.50s then the dialog title
  159. will also show "(for PKZIP v2.x only)" indicating
  160. that only archives created with PKZIP version 2.0
  161. and later can be unzipped (see "Variants of
  162. UNZIP.IMG" later on in this file).
  163.  
  164. Pressing [Esc] from the dialog will exit Unzip and
  165. save the last used directories to an UNZIP.INI
  166. file. The UNZIP.INI file will be created on your
  167. default disk if it does not already exist.
  168.  
  169. Press [Help] from the dialog to access the optional
  170. online Help. If you did not install the UNZIP.HLP
  171. file, then the author information will be displayed
  172. instead.
  173.  
  174.  
  175.  
  176. Unzip's Dialog
  177. ==============
  178. Unzip from file
  179. ---------------
  180. Unzip displays files initially in the \ (root)
  181. directory on your default disk.
  182. Press [Tab] to bring up the file selector to
  183. select any file you wish.
  184. You can also access remote drives on your PC using
  185. either PsiWin or RCom - see the section "Accessing
  186. Remote Drives with Unzip" later on in this file.
  187. When Unzip exits, it saves the last used directory
  188. in the UNZIP.INI file.
  189.  
  190.  
  191.  
  192. Unzip to directory
  193. ------------------
  194. Unzip will initially unzip to \ on your default
  195. disk.
  196. Press [Tab] for the file selector to select any
  197. other directory.
  198. You can also unzip to remote drives on your PC
  199. using either PsiWin or RCom - see the section
  200. "Accessing Remote Drives with Unzip" later on in
  201. this file.
  202. When Unzip exits, it saves the last used directory
  203. in the UNZIP.INI file.
  204.  
  205.  
  206.  
  207. Action
  208. ------
  209. Extract files (default)
  210.  This will extract all the zipped files in the
  211.  archive.
  212.  
  213. Update existing & create new
  214.  This will unzip files only if the zipped files
  215.  have a timestamp which is newer than the
  216.  existing files in the destination directory
  217.  (existing files will be overwritten), and it will
  218.  also create any new files that do not exist.
  219.  This is a good choice if you want to unzip an
  220.  archive directly to a flash SSD. Unchanged files
  221.  will *not* be overwritten, thus saving precious
  222.  flash SSD space.
  223.  
  224. Freshen (update existing only)
  225.  This does the same as above except that *no* new
  226.  files are created.
  227.  This is the best choice if you wish to update an
  228.  existing program but you do *not* want to unzip
  229.  files that you do not have installed (eg: text
  230.  files and optional files).
  231.  A good choice when unzipping a newer program
  232.  version directly to a flash SSD.
  233.  NOTE: UNZIP.IMG complains if you choose this
  234.  action together with the overwrite option "Never".
  235.  
  236. Test archive integrity
  237.  Test to see if the archive's files are not
  238.  corrupted and if they can be unzipped OK by
  239.  UNZIP.IMG .
  240.  
  241. Display archive comment
  242.  Does just that.
  243.  NOTE: many archives do not use the comment
  244.  feature however FUNZIP12.ZIP does!
  245.  
  246. List files (short)
  247.  Displays all the files in the archive showing
  248.  just size, date, time and name.
  249.  
  250. List files (long)
  251.  This does the same as the short list but displays
  252.  a bit more information about each file.
  253.  
  254. Create file list (short)
  255.  Creates a "\WRD\Filelist.wrd" file on your
  256.  default disk containing the short file list.
  257.  The file list is overwritten each time.
  258.  This is very useful to see what files are in the
  259.  archive, and as the file list is viewed in Word,
  260.  gives a better display (especially when the
  261.  archive contains many files) then the "List files"
  262.  above. You can also print the file list from Word.
  263.  
  264. Create file list (long)
  265.  The same as above but with more information
  266.  about each file.
  267.  
  268.  
  269.  
  270. File types
  271. ----------
  272. All (*.*), Readme (readme.*), Text (*.txt),
  273. Text (*.doc), Word (*.wrd), Agenda (*.agn),
  274. Data (*.dbf), Sound (*.wve), Sheet (*.spr),
  275. World (*.wld), Executable (*.app),
  276. Executable (*.opa), Executable (*.opo)
  277.  You can select which files you wish to extract.
  278.  This is handy if you just wish to extract just
  279.  some files first (and maybe read them) before
  280.  extracting the rest of the files.
  281.  Only files that match the selected file type will
  282.  be extracted.
  283.  A match is made when:
  284.   * the archived filename is stored in all lower
  285.     or upper case (ie: readme.* or README.*)
  286.   * the first letter of the matching text is upper
  287.     case and the rest is lower case
  288.     (ie: Readme.*, *.Txt, *,Dbf, etc.)
  289.  You can check how the archived filenames are
  290.  stored by creating a file list.
  291.  
  292.  
  293.  
  294. Overwrite
  295. ---------
  296. NOTE: overwrite options do not apply to the
  297. "Create file list" action.
  298.  
  299. Prompt
  300.  Unzip will ask you what to do if it finds an
  301.  existing file when extracting.
  302.  
  303. Never
  304.  Unzip will *never* overwrite any existing files.
  305.  NOTE: UNZIP.IMG complains if you choose
  306.  overwrite together with "Action: Freshen (update
  307.  existing only)"
  308.  
  309. Always
  310.  Unzip will *always* overwrite existing files.
  311.  
  312.  
  313.  
  314. Options
  315. -------
  316. None
  317.  No options.
  318.  
  319. Discard paths
  320.  If the archive contains paths, normally they are
  321.  extracted and created when unzipping.
  322.  Choosing this option will *prevent* the paths
  323.  from being created, and all files will be
  324.  unzipped to the same directory.
  325.  
  326. Quiet operation
  327.  Prevents some text from being displayed on the
  328.  screen or saved to the file list.
  329.  
  330. Very quiet operation
  331.  Even quieter than quiet operation.
  332.  
  333.  
  334.  
  335. Illegal Combinations
  336. ====================
  337. UNZIP.IMG will complain if you select both
  338. "Action: Freshen (update existing only)" AND
  339. "Overwrite: Never"
  340.  
  341.  
  342.  
  343. Variants of UNZIP.OPA
  344. =====================
  345. The Unzip shell is enclosed in this archive
  346. in two variants:
  347.  
  348. UNZIP.OPA (2937 bytes)
  349.  Series 3a variant (v1.2)
  350.  For the series 3a only, will not run on the 
  351.  series 3. Full utilisation of series 3a
  352.  display size and help system.
  353.  
  354. UNZIP.CLS (2401 bytes)
  355.  Series 3 classic variant (v1.2c)
  356.  Pruned-down variant for the series 3. Will
  357.  run on the series 3a as well, but 3a users are
  358.  encouraged to install the 3a variant.
  359.  The classic variant is slightly different to
  360.  the series 3a variant:
  361.   * No help system possible (so do not 
  362.     install UNZIP.HLP)
  363.   * Main dialog split into two sections and 
  364.     some dialog text shortened due to display
  365.     space limitations
  366.  If you need to install the series 3 classic
  367.  variant, then rename the file UNZIP.CLS
  368.  to UNZIP.OPA and install as shown above in
  369.  the installation section.
  370.  All of the unzip features are supported in
  371.  the series 3 classic variant.
  372.  
  373.  
  374.  
  375. Variants of UNZIP.IMG
  376. =====================
  377. UNZIP.IMG v1.50 comes in two variants:
  378.  
  379. v1.50l (large variant, 42160 bytes, *preferred*)
  380.  Can extract files compressed with both PKZIP v1.x
  381.  and PKZIP v2.x
  382.  Install this variant if you have the space
  383.  available (highly recommended)
  384.  
  385. v1.50s (small variant, 32816 bytes)
  386.  Can only extract files compressed with PKZIP
  387.  v2.x. Attempting to extract files compressed
  388.  with PKZIP v1.x will produce "unknown compression
  389.  method" errors.
  390.  Unzip knows if you have v1.50s by displaying the
  391.  text "(for PKZIP v2.x only) in the dialog title.
  392.  Install this variant if you are short on memory
  393.  space and do not need to unzip PKZIP 1.x archives.
  394.  
  395.  
  396.  
  397. UNZIP.IMG Compatibility
  398. =======================
  399. This version of Unzip has been designed to work
  400. purely with v1.50s and v1.50l of UNZIP.IMG
  401. I have tested UNZIP.OPA with both versions of
  402. UNZIP.IMG...
  403.  
  404.   Version  Size   Time     Date
  405.    v1.50l  42160  01:50  13-Jun-96
  406.    v1.50s  32816  01:50  13-Jun-96
  407.  
  408.   s = small, for PKZIP 2.x only
  409.   l = large, for PKZIP 1.x and 2.x
  410.  
  411. ...and both work happily.
  412.  
  413. Older versions of UNZIP.OPA provide support for
  414. older UNZIP.IMG image files, see the change
  415. history below.
  416.  
  417.  
  418.  
  419. Solving Problems
  420. ================
  421. Error messages that show "Unzip" on the top of the
  422. screen and the Unzip icon are from the Unzip shell.
  423. Common error messages are:
  424.  
  425. "Unzip.img not found"
  426.  at startup means that the file UNZIP.IMG is not in
  427.  the same directory on the same disk as UNZIP.OPA.
  428.  Reinstall UNZIP.IMG v1.50 to the same place
  429.  as UNZIP.OPA
  430.  
  431. "Wrong Unzip.img"
  432.  at startup means that your UNZIP.IMG file is not
  433.  version v1.50.
  434.  Install UNZIP.IMG v1.50
  435.  
  436. "Error in UNZIP\M   Invalid name" or
  437. "Error in UNZIP\M   End of file"
  438.  at startup means that the UNZIP.INI file is
  439.  corrupt.
  440.  Delete UNZIP.INI (it is on your default disk)
  441.  The INI file will be recreated automatically.
  442.  
  443. "Error in UNZIP\M   Write protected"
  444.  after pressing [Enter] to continue from the
  445.  dialog means that the UNZIP.INI file cannot be
  446.  written as the default disk is write protected.
  447.  Change the default disk from the system screen.
  448.  
  449. "Error in UNZIP\M   File or device in use"
  450.  after pressing [Enter] to continue from the
  451.  dialog means that the UNZIP.INI file cannot be
  452.  written as it is being used by another program
  453.  (maybe you are viewing it with Word?)
  454.  Find the program using UNZIP.INI and exit it.
  455.  
  456.  
  457. Error messages that occur when "UnZip v5 for
  458. EPOC (version 1.50x)" is displayed are from the
  459. UNZIP.IMG file.
  460. Common error messages are:
  461.  
  462. "can't allocate the work area"
  463.  There is not enough free memory for the 
  464.  UNZIP.IMG file to run.
  465.  Close other applications and delete unnecessary
  466.  files to free up some disk memory.
  467.  UNZIP.IMG needs about 100k free memory to run.
  468.  
  469. "Cannot create [file]: write error or (disk full?)"
  470.  UNZIP.IMG could not unzip any more files as the
  471.  disk is most probably full.
  472.  Close other applications and delete unnecessary
  473.  files to free up some disk memory.
  474.  
  475. "End-of-central-directory signature not found"
  476.  The file you are trying to unzip is not a PKZIP
  477.  compatible archive.
  478.  Choose the correct file.
  479.  
  480. "error:  invalid response [x]"
  481.  UNZIP.IMG was asking you to press a certain key
  482.  and you pressed key [x] instead.
  483.  Press a correct key.
  484.  
  485. "unknown compression method"
  486.  Archive was probably created with PKZIP v1.x
  487.  and you are using UNZIP.IMG v1.50s.
  488.  Install v1.50 variant l.
  489.  
  490.  
  491.  
  492. Accessing Remote Drives with Unzip
  493. ==================================
  494. Accessing remote drives is possible with
  495. either PsiWin or RCom. MCLink has not been
  496. tested.
  497. Remote drives will always appear in the file
  498. selector prefixed with "REM::"
  499. NOTE: The default setting of PsiWin will not
  500. allow remote access of PC files from the
  501. Psion.
  502. You can change this by editing the
  503. PSIONPRC.INI file in the Windows directory,
  504. and removing the '-x' from the end of the 
  505. line "engine=prcenwin.exe -x"
  506.  
  507.  
  508.  
  509. Acknowledgements
  510. ================
  511. Full and grateful acknowledgements go to David
  512. Palmer of Edinburgh, Scotland, for his wonderful
  513. UNZIP.IMG and his excellent documentation.
  514.  
  515.  
  516.  
  517. Change History
  518. ==============
  519. 21-Jun-96 v1.2
  520.  Created series 3 classic variant (v1.2c).
  521.  Reduced runtime memory requirements by 47%.
  522.  File selector now shows all files (* instead 
  523.   of *.zip).
  524.  Removed support for earlier versions of
  525.   UNZIP.IMG to force the user to upgrade to
  526.   v1.50 (s or l) and to reduce code size.
  527.  Added better error handling when trying to
  528.   find or detect the UNZIP.IMG file.
  529.  Changed the icon.
  530.  Unzip now remembers last directories used
  531.   in UNZIP.INI.
  532.  Added (optional) online help.
  533.  Added ability to extract certain "File types".
  534.  Added "Create file list" action.
  535.  Rearranged the dialog layout and changed some
  536.   dialog text.
  537.  
  538. 07-May-96 v1.1
  539.  Added support for UNZIP.IMG v1.0/1.2/1.3.
  540.  Renamed a couple of options and fixed a spelling
  541.   mistake.
  542.  Optimised code to make the .OPA as small as
  543.   possible.
  544.  
  545. 01-May-96 v1.0
  546.  Original version (only for UNZIP.IMG v1.41).
  547.  
  548.  
  549. -------------------
  550. Jochen Siegenthaler
  551. Zurich, Switzerland
  552. 21 June, 1996
  553. 100127.3167@compuserve.com
  554.  
  555.